一、BaseLog.Config
配置日志输出信息的构建类,该类用于创建日志输出的配置信息
- 以下方法说明中明确提供不推荐使用的方法,即为不建议开发者调用或者是开发者不应该进行任何数据修改。
- 以下文档中未提及的方法均属于不推荐使用的方法
二、Reference
以下为此类中关联的Class及相关说明
类名 | 类型 | 说明 |
---|---|---|
Loggable | 接口 | 日志输出接口 |
三、Field
以下为此类中的常用字段及说明。
3.1、Attributes
由于此类包含的属性较多,不一一罗列其属性的getter/setter
方法,以下字段都支持对应的方法,方法列表中不再赘述。大部分情况下,以下属性为仅读属性
字段名 | 字段类型 | getter支持返回null | 说明 |
---|---|---|---|
字段名 | 字段类型 | getter支持返回null | 说明 |
defaultTag | String | - | 默认的日志输出标识 |
logPreFix | String | - | 日志的前缀文本 |
logoutPath | String | - | 日志输出文件路径 |
enabledLogFile | boolean | - | 是否启用日志输出文件 |
debugLevel | int | - | 日志输出等级,默认为 ERROR |
bufferLevel | int | - | 日志输出到文件的等级,默认为 ERROR |
loggable | Loggable | - | 日志输出接口 |
debugLevel 与 bufferLevel 等级均使用 Loggable 中的等级常量。
3.2、Loggable Level
字段名 | 值 | 说明 |
---|---|---|
VERBOSE | 2 | 冗余的日志等级,所有的日志内容都会输出 |
DEBUG | 3 | 调试的日志等级,大部分的日志会集中以此等级输出 |
INFO | 4 | 信息的日志等级,小部分非调试型日志以此等级输出 |
WARN | 5 | 警告的日志等级,部分警告型日志以此等级输出 |
ERROR | 6 | 错误的日志等级,异常或错误日志以此等级输出 |
NONE | Integer.MIN_VALUE | 无日志等级,不输出日志 |
四、Relevant Class
以下为此类中的关联类或内部类
4.1、Loggable
Loggable 为日志输出接口,在实际的不同平台或者环境下,可能输出的日志输出的目标是不一样的(如控制台,文件或其它程序等),通过此接口可以定义将日志信息输出到什么位置显示。
int log(int level, @Nullable String tag, @NotNull String msg, @Nullable Throwable e)
五、更新日志
日期 | 更新内容 |
---|---|
2018-09-19 | 初稿,自 X-MQTT SDK v6.2版本起 |